Inside Macintosh: QuickDraw GX Printing Extensions and Drivers /

Chapter 5 - Printing Functions for Message Overrides / Printing Functions Reference

Functions / Adding a Panel to a Print Dialog Box

GXSetupDialogPanel

You can use the GXSetupDialogPanel function to add a panel to a print dialog box.

OSErr GXSetupDialogPanel (gxPanelSetupRecord *panelRec);

panelRec

A pointer to a panel setup structure.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXSetupDialogPanel function adds a panel, as defined by the information in the panel setup structure, to a print dialog box. You call this function from within your override of the GXJobPrintDialog, GXFormatDialog, and GXJobDefaultFormatDialog messages, before forwarding the message.

RESULT CODES

gxSegmentLoadFailedErr	A required code segment could not be found, or there was not enough memory to load it.
gxPrUserAbortErr	The user has canceled printing.
gxCantAddPanelsNowErr	Panels can only be added to a dialog box when the current driver is switched. This error is generated if a panel addition request is made at any other time.
gxBadxdtlKeyErr	An unknown key value was specified for an item in an extended dialog control resource.
gxXdtlItemOutOfRangeErr	An item referenced by the panel does not belong to the panel.
gxNoActionButtonErr	The action button for the panel is nil.
gxTitlesTooLongErr	The length of the button titles exceeds the maximum width allowed for a printing alert.

SEE ALSO

You can find an example of using the GXSetupDialogPanel function in Listing 2-10 on page 2-18 in the chapter "Printing Extensions."

The gxPanelSetupRecord structure is described in the section "The Panel Setup Structure" on page 5-15.

The GXJobPrintDialog, GXFormatDialog, and GXJobDefaultFormatDialog messages are described in the chapter "Printing Messages" in this book.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help